home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 43 / Amiga Format CD43 (1999)(Future Publishing)(GB)(Track 1 of 2)[!][issue 1999-09].iso / -serious- / graphics / jpegtool / jpegtool.doc < prev    next >
Text File  |  1999-06-15  |  6KB  |  176 lines
  1.                       JpegTool
  2.         © 1999 by Stephan Rupprecht
  3.             All rights reserved.
  4.  
  5.  
  6. COPYRIGHT AND DISCLAIMER
  7.  JpegTool is copyrighted 1999 by Stephan Rupprecht. All rights
  8.  reserved. This program is freeware, so no financial donations
  9.  required. Redistribution allowed if the package is left unchanged.
  10.  The author is not responsible for any damage caused by the use
  11.  or misuse of this documentation and/or the program(s) it describes.
  12.  
  13.  
  14. REQUIREMENTS
  15.  Any Amiga® (compatible) computer with at least OS3 and '020+ cpu.
  16.  jpeg.library v2+ by Paul Huxham (util/libs/jpeglibrary*.lha or
  17.   http://mafeking.scouts.org.au/~paulh).
  18.  picture.datatype v43 and datatypes.library v45 (optional, see later).
  19.  
  20.  The gui program by Nils Goers requires:
  21.   triton.library, tritonrexx.library, rexxsupport.library
  22.  
  23.  
  24. DESCRIPTION
  25.  JpegTool allows you to convert any image that is recognized by 
  26.  datatypes into a jpeg image and vice versa.
  27.  
  28.  Features (mainly provided by jpeg.library)
  29.   · can create thumbnails from jpegs.
  30.   · allows to create progressive images (jpeglib v5).
  31.   · provides block smoothing for decompression (jpeglib v5).
  32.   · dct method (jpeglib v4) as well as quality and smoothing
  33.     factor can be changed.
  34.   · optionally creates grayscale images.
  35.  
  36.  
  37. INSTALLATION
  38.  Simply copy JpegTool to where-ever-you-want :)
  39.  
  40.  
  41. USAGE
  42.  You can start JpegTool only from shell, since it's a DOS command
  43.  (except for the possibility to start it from Workbench through
  44.  the menu item 'Execute Command...'). The following options are
  45.  provided:
  46.  
  47.     FROM/M/A,TO/A,DESTDATATYPE=DATATYPE=DTN/K,Q=QUALITY/N/K,
  48.     S=SMOOTHING/N/K,DCT=DCTMETHOD/K,BS=BLOCKSMOOTHING/S,
  49.     P=PROGRESSIVE/S,SN=SCALENUM/N/K,SD=SCALEDENOM/N/K,
  50.     SC=SCALE/N/K,GS=GRAYSCALE/S,FORCE/S,ALL/S,FLIPX/S,
  51.     FLIPY/S,QUIET/S
  52.  
  53.  FROM/M/A: specifies the image(s) to convert, patterns will be accepted.
  54.  
  55.  TO/A: name of the new image(s). The specified filename is not necessarily 
  56.   just a simple identifier representing exactly one disk object. Instead, 
  57.   it is a template which may contain variables/placeholders which will 
  58.   be replaced by their actual values. Placeholders recognized are:
  59.   
  60.    %n   name of the source file without suffix. You can shorten the
  61.         filename by providing the maximum number of characters allowed
  62.         between % and n (eg. %5n).
  63.    %nu  Each time an image is converted an internal counter will be
  64.        increased. %nu holds the current value of this counter.
  65.    %w   width of the image.
  66.    %h   height ...
  67.    %d   depth ...
  68.    %sz  shortcut for %wx%hx%d.
  69.    %s   suffix _without_ leading point. If you convert an image to jpeg, the 
  70.         suffix will be 'jpg' otherwise the name of the datatype specified
  71.         via DATATYPE will be taken as suffix (exception: 'picture' will be
  72.         turned into 'ilbm').
  73.         
  74.    example: this will create thumbnails from all jpg files in the current
  75.     directory. jpegtool #?.jpg %20n_thumb.%s sd=8
  76.    
  77.   NOTE: Source and destination MUST NOT be the same file !
  78.  
  79.  DESTDATATYPE=DATATYPE=DTN/K: tells the program to create a datatypes
  80.   object from a jpeg stream. To create an ilbm picture specify
  81.   DTN=picture (no .datatype ending!). This option requires picture
  82.   datatype v43 and datatypes.library v45! And, of course, the
  83.   specified subclass of picture    dt must be v43 compatible and provide
  84.   an encoder.
  85.  
  86.  Q=QUALITY/N/K: quality of the jpeg stream to create (1%..100%).
  87.   default: 75
  88.  
  89.  S=SMOOTHING/N/K: smoothing factor of the jpeg stream to create
  90.   (0%..100%). default: 0 (= no smoothing)
  91.  
  92.  DCT=DCTMETHOD/K: allows to specify the dct method used for
  93.   de-/encoding. The following keywords are recognized:
  94.     ISLOW: integer, slow, more accurate (default).
  95.     IFAST: integer, fast, less accurate.
  96.     FLOAT: float, fast on fast machines, most accurate.
  97.  
  98.  BS=BLOCKSMOOTHING/S: do block smoothing when decompressing.
  99.  
  100.  P=PROGRESSIVE/S: create progressive jpeg.
  101.  
  102.  SN=SCALENUM/N/K: scaling numerator when decompressing a jpeg image.
  103.   The jpeg code only supports a value of 1 (default) currently.
  104.  
  105.  SD=SCALEDENOM/N/K: scaling denominator when decompressing a jpeg
  106.   image. Denominators supported are 1 (default), 2, 4 and 8. Eg. if
  107.   you want to have an image that is halve of the size of the original 
  108.   one specify SD=2.
  109.   
  110.  SC=SCALE/N/K: scale factor as exponent from 0..3, overrides SCALENUM
  111.   and SCALEDENOM.
  112.  
  113.  GS=GRAYSCALE/S: create grayscale image. 
  114.  
  115.  FLIPX/S: mirrors the image horizontally.
  116.  
  117.  FLIPY/S: mirrors the image vertically.
  118.  
  119.  FORCE/S: overwrite existing files.
  120.  
  121.  ALL/S: convert subdirectories, too. A new directory in the destination
  122.   drawer _won't_ be created!
  123.  
  124.  QUIET/S: suppresses any message except error messages.
  125.  
  126.  
  127. PROBLEMS
  128.  The ffp version of jpeg.library will probably cause your computer to
  129.  crash, so better use the standard one or the fpu version (if possible).
  130.  The latest release of jpeg.library no longer includes an ffp version.
  131.  
  132.  
  133. HISTORY
  134.  1.0  first public release
  135.  1.1  fixed a few non-serious bugs. added grayscale option. creates
  136.       an 8bit image from a grayscale jpeg, now (before truecolor).
  137.       fixed p96 picturedt problems.
  138.  1.2  Wrong aspect ratio was saved when creating a datatypes object.
  139.       Improved FROM and TO option, now multiple files / whole directories
  140.       can be converted at once. Included JpegToolGUI by Nils Goers.
  141.  1.3  added FORCE/S option. uses raw mode for input now (when asking you
  142.       for permission to overwrite an existing file) to avoid that the
  143.       input appears in cons' history. when overwriting an existing file
  144.       the filesize didn't change in case that the file was larger before.
  145.       added filesize to the output. Nils updated his gui program.
  146.  1.4  new ALL/S option. to convert a directory you don't need to give a
  147.       pattern anymore (ie. myimages/#? -> myimages). no longer assumes
  148.       that anything behind the first point of the source name is a suffix
  149.       (see %n placeholder).
  150.  1.5  added FLIPX/S,FLIPY/S,SCALE/N/K options. supports ham and ehb sources.
  151.       fixed a few small bugs.
  152.  
  153.  
  154. FUTURE
  155.  bugfixes ;)
  156.  your suggestions
  157.  
  158.  
  159. SPECIAL THANKS GO TO (in order of appearance:)
  160.  Paul Huxham for jpeg.library.
  161.  Olaf Barthel for his help.
  162.  Nils Goers <n.goers@goers.art-line.de> for the gui program.
  163.  
  164.  
  165. AUTHOR
  166.  Please send bug reports and ideas to
  167.  
  168.      Stephan Rupprecht
  169.      Apfeldweg 1
  170.      D44359 Dortmund
  171.      Germany
  172.  
  173.  Send emails to
  174.  
  175.      stephan.rupprecht@gmx.de
  176.